Contexto global

GetFilesFromServerAsync

Variante de sintaxis: Con diálogo

Sintaxis:

GetFilesFromServerAsync(<ArchivosAObtener>, <ParametrosDialogoObtenerArchivos>, <ParametrosArchivoObtenerArchivos>)

Parámetros:

Tipo: Array.
Un array de objetos TransferableFileDescription.
Cada objeto describe un archivo que se va a recuperar:

• Location – ubicación de los datos en un almacenamiento temporal o en la base de datos. El valor no puede ser una cadena vacía. De lo contrario, se genera un mensaje de error.
• Name – ruta completa o relativa al archivo. La ruta relativa se combinará con el valor del parámetro <BasicDirectory>.

Tipo: GetFilesDialogParameters.
La estructura que contiene los parámetros del cuadro de diálogo que se mostrará al usuario.

Tipo: GetFilesArchiveParameters.
Parámetros utilizados para recibir archivos como un archivo comprimido. Si no se especifica el parámetro, los archivos recibidos no se comprimirán.

Descripción de la variante del método:

Inicia la recepción de archivos mostrando el cuadro de diálogo y los guarda en el sistema de archivos local del usuario.

El resultado de la ejecución de la promesa se rellena instantáneamente (en el cliente web – antes de que se muestre el cuadro de diálogo, en otros clientes – después de que se muestre el cuadro de diálogo) con Undefined.

El cliente web no requiere la extensión del sistema de archivos, pero la utiliza si ya está instalada. En el cliente web sin la extensión del sistema de archivos instalada, se ignoran las configuraciones del parámetro <ParametrosDialogoObtenerArchivos>.

Variante de sintaxis: Sin diálogo

Sintaxis:

GetFilesFromServerAsync(<ArchivosAObtener>, <DirectorioBase>, <ParametrosArchivoObtenerArchivos>)

Parámetros:

Tipo: Array.
Un array de objetos TransferableFileDescription.
Cada objeto describe un archivo que se va a recuperar:

• Location – ubicación de los datos en un almacenamiento temporal o en la base de datos. El valor no puede ser una cadena vacía. De lo contrario, se genera un mensaje de error.
• Name – ruta completa o relativa al archivo. La ruta relativa se combinará con el valor del parámetro <BasicDirectory>.

Tipo: String.
Establece el directorio base con respecto al cual se determina la ubicación final de cada archivo.
Si hay rutas relativas entre las descripciones de los archivos recibidos, o se establece el modo de recuperación de archivo GetArchiveAlways, se requiere el parámetro <DirectorioBase>.

Tipo: GetFilesArchiveParameters.
Parámetros utilizados para recibir archivos como un archivo comprimido. Si no se especifica el parámetro, los archivos recibidos no se comprimirán.

Descripción de la variante del método:

Inicia la recepción de archivos y los guarda en el sistema de archivos local del usuario.
La extensión de operación de archivo es requerida en el cliente web.

El resultado de la ejecución de la promesa es una matriz de objetos del tipo TransferredFileDescription.

Valor devuelto:

Tipo: Promise.

Descripción:

Función asíncrona. Obtiene archivos del servidor.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Consulte también:

Contexto global, método BeginGettingFiles
Contexto global, método BeginGetFilesFromServer
Contexto global, método GetFile
Contexto global, método GetFiles

Disponible desde:

Disponible desde la versión 8.3.15.

Descripción cambiada en la versión 8.3.18.

---